home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / util / cdity / CRSnap.lha / CRSnap.doc < prev    next >
Text File  |  1997-03-07  |  3KB  |  80 lines
  1.  
  2.  
  3.     CRSnap - screen snapshot commodity,
  4.              by C.R. 'Magius' Hahn
  5.  
  6.     CRSnap is a quick and simple screen snapshot commodity that, unlike
  7.     some OTHER screen snapshot commodities, FUNCTIONS CORRECTLY!!!
  8.  
  9.     FEATURES:
  10.         Handles all standard OCS/ECS and AGA screenmodes.
  11.         Handles V39-40 interleaved bitmaps.
  12.         Saves as compressed IFF ILBM.
  13.         Audio Completion Signal (requires OS3.0+)
  14.         ARexx Port
  15.  
  16.     USAGE:
  17.         CLI or workbench (standard and NI icon included).  CRSnap
  18.         will auto-detach if run from CLI.  When running, press the
  19.         hotkey, and CRSnap saves the frontmost screen as a compressed
  20.         ILBM.  The filename will be CRSnap###.ilbm, where ### is a number
  21.         from 000 through 999. (CRSnap won't overwrite previous snaps,
  22.         you see.)  CRSnap always saves using the lowest numbered file
  23.         that doesn't already exist.  If every possible file of the
  24.         1000 files already exist, well, let's not consider that
  25.         possibility.... It's messy...... very....
  26.         Don't worry, though, it's not likely you will ever reach this
  27.         1000-file limit.
  28.  
  29.     TOOLTYPES/PARAMETERS:
  30.         The CLI interface is standard ReadArgs.
  31.  
  32.           CX_PRIORITY/K/N,SNAPKEY/K,SNAPPATH/K,SNAPSOUND/K
  33.  
  34.         Or, if you don't understand template-ese:
  35.  
  36.           CRSnap [CX_PRIORITY=<n>] [SNAPKEY=<key>] [SNAPPATH=<path>]
  37.             [SNAPSOUND=<soundfile>]
  38.  
  39.         For Workbench, the tooltypes are identical.  SNAPKEY is the
  40.         hotkey string, in the 'normal' format (ie. "ctrl lalt s"),
  41.         and SNAPPATH tells CRSnap what directory to put the snapped
  42.         files into.  SNAPSOUND is new, and resulted from a suggestion
  43.         by a very nice person, you know who you are. :)  If given,
  44.         CRSnap will play the given sound file when it is finished saving.
  45.         The datatypes.library is used, so the sound can be in any format
  46.         for which you have a datatype.  The default values for these can
  47.         be found in the icon, but here they are again:
  48.  
  49.             CX_PRIORITY=0
  50.             SNAPKEY=lcommand rcommand f10
  51.             SNAPPATH=sys:t
  52.             SNAPSOUND=
  53.  
  54.  
  55.     AREXX:
  56.         The ARexx port name is "CRSNAP", and it understands one command,
  57.         "SNAP" (case is ignored)  The full path name of the created
  58.         file is returned in the result string.
  59.  
  60.  
  61.     NOTES:
  62.       - As with many such utilities, CRSnap only understands
  63.         intuition screens.  (can't snap custom viewports, or displays
  64.         with more than one screen - sorry)
  65.  
  66.  
  67.     THANKS to Jan Van Den Baard (sp?) - for DCBack.lib
  68.  
  69.  
  70.     Contact:    C.R. 'Magius' Hahn
  71.                 Box 403
  72.                 Montmartre, SK
  73.                 S0G 3M0
  74.                 Canada
  75.  
  76.          email (1997 only): hahn@cs.uregina.ca
  77.                         or: skail@geocities.com
  78.  
  79.  
  80.